home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Extra 1996 #3 / AmigaPlus_CD-ROM-EXTRA_Nr.3.bin / aminet-spiele / zwei spieler / gridlock / doc.txt / gridlock.doc.txt < prev   
Text File  |  1994-12-10  |  43KB  |  1,277 lines

  1. GridLock Help
  2. ----------------------------------------------------------------------------
  3.                      ' Those who move among the Grid '
  4.  
  5.                                   GridLock
  6.                                 v 94.Dec.10
  7.  
  8.    Shareware                             Screen Areas 
  9.    GridLock - The Book     
  10.    Development and Testing               Movement and Energy Beams        
  11.                                          Opponent Activity Pulser         
  12.    Setting Up                            Health                           
  13.    For NULL-MODEM                        Inactivity / Health Rejuvenation 
  14.    For MODEM                             Disruptors                       
  15.    For AmiTCP/TCP:                       Disruptions / Inactivity         
  16.    For Multi-I/O Cards                   Teleportation Devices            
  17.    Connecting MODEM/NULL-MODEM           Phimping                         
  18.    Connecting AmiTCP/TCP:      
  19.    Starting                              Sending Messages 
  20.  
  21.    Configuration 
  22.                                          Pause Game 
  23.    Error Messages                        End Game   
  24.                                          Quitting   
  25.    Future Enhancements 
  26.    Known BUGS                            Winning 
  27.  
  28.    Note to 512K users                    Legalness  
  29.                                          Thank Yous 
  30.  
  31.    New in this version 
  32.    Previous versions                                  Locating The Author 
  33.  
  34.  
  35.      GridLock is a MODEM or NULL-MODEM or AmiTCP/TCP: two-player game.
  36. ============================================================================
  37. GridLock - Shareware
  38. ----------------------------------------------------------------------------
  39. GridLock - Shareware
  40. --------------------
  41.  
  42. A great deal of time has been spent in the development of GridLock.  If
  43. you continue using this game, a Shareware fee of $10.00 or more (CANADIAN)
  44. is requested.  Shareware fees of $15.00 or more will receive the next
  45. version of GridLock at no charge.  See:  Locating The Author 
  46.  
  47. This version is not disabled in any way; and there are no annoying
  48. requestors that pop up.  I trust you to send me the fee if you use this
  49. software.
  50.  
  51. Your shareware payment helps to insure continued development of GridLock.
  52. See:  Future Enhancements 
  53. ============================================================================
  54. GridLock - The Book
  55. ----------------------------------------------------------------------------
  56. GridLock - The Book
  57. -------------------
  58.  
  59. I will be writing a book, the story of GridLock.  This will be a science
  60. fiction book detailing the life of ' Those who move among the Grid '.  It
  61. will contain a complete description of the workings of the Grid, as well
  62. as hints and strategies from GridLock players.  This will be available to
  63. anyone who writes me, at a minimal cost.
  64.  
  65. If you wish to be one of those lucky few who will have their strategies
  66. included in the book, then write to me detailing strategy information and
  67. the history of your Grid player.
  68.  
  69. Write to me for more information.  See:  Locating The Author 
  70. ============================================================================
  71. Development and Testing
  72. ----------------------------------------------------------------------------
  73. Development and Testing
  74. -----------------------
  75.  
  76. GridLock was originally developed on an Amiga 1000 with 1.5 Meg, beginning
  77. in October of 1990.  It is now being developed on an Amiga 3000T/25MHz
  78. with 10 Meg.
  79.  
  80. GridLock has been tested on an A3000/4 Meg FAST/2 Meg CHIP, A3000T/8 Meg
  81. FAST/2 Meg CHIP memory.
  82.  
  83. GridLock has been tested under Kickstart version 37.175, Workbench
  84. version 38.12.
  85.  
  86. GridLock has been modem tested with a ZyXEL U-1496E+.
  87.  
  88. GridLock has been tested with the MultiFace-III Multi-I/O card.
  89.  
  90. GridLock has been tested with AmiTCP/TCP: (v2.3) on a 115200 baud
  91. serial.device network between an A3000T/25MHz and an A3000/25MHz.
  92. ============================================================================
  93. Setting Up
  94. ----------------------------------------------------------------------------
  95. Setting Up
  96. ----------
  97.  
  98. Both players should be using the same version of GridLock.  In versions
  99. 91.Dec.01 and greater, version checks are made automatically.
  100.  
  101. GridLock requires the following libraries to be located in the LIBS:
  102. directory:
  103.  
  104.      dos.library                   (system)
  105.      exec.library                  (system)
  106.      graphics.library              (system)
  107.      icon.library                  (system)
  108.      intuition.library             (system)
  109.      mathieeedoubbas.library       (system)
  110.  
  111.      iff.library                   (included)
  112.  
  113. GridLock requires the following device to be located in the DEVS:
  114. directory, for use with the internal serial port:
  115.  
  116.      serial.device                 (system)
  117.  
  118. GridLock requires the following handler to be located in the L:
  119. directory, for use with the internal serial port:
  120.  
  121.      port-handler                  (system)
  122.  
  123. The following files should be contained in the same directory:
  124.  
  125.      GridLock                     87476 bytes
  126.      GridLock.info                ????? bytes
  127.  
  128.      GridLockData/GridLock.pic    17342 bytes
  129.      GridLockData/GridLock.pic2   32216 bytes
  130.      GridLockData/GridLock.RAW     8364 bytes
  131.      GridLockData/GridLock.txt     1365 bytes
  132.      GridLockData/Soound1.RAW     10724 bytes
  133.      GridLockData/Soound2.RAW     14760 bytes
  134.      GridLockData/Soound4.RAW      1022 bytes
  135.      GridLockData/Soound7.RAW      8594 bytes
  136.      GridLockData/Teleport.RAW    19456 bytes
  137. ============================================================================
  138. Note to 512K users
  139. ----------------------------------------------------------------------------
  140. Note to 512K users
  141. ------------------
  142.  
  143. If you only have 512K of memory you will most likely encounter an OUT OF
  144. MEMORY error when beginning the game.  If this happens, try adding the
  145. SOUNDEFFECTS=NO configuration option.  See:  Configuration 
  146. ============================================================================
  147. For NULL-MODEM
  148. ----------------------------------------------------------------------------
  149. For NULL-MODEM
  150. --------------
  151.  
  152. Connect both computers with a NULL-MODEM (3 wire) serial cable.
  153.  
  154.         WARNING!    NEVER connect cables of any kind to your Amiga
  155.                     while the Amiga is turned on.
  156.  
  157. The following ToolType may be added (SERIAL is default):
  158.  
  159.                               DEVICE=SERIAL
  160.  
  161.  
  162.  
  163. See:  Configuration 
  164. Applicable Configuration Commands:
  165.  
  166.                             BAUDNULL   DEVICE 
  167.  
  168.                          SERIALDEVICE   SERIALUNIT 
  169. ============================================================================
  170. For MODEM
  171. ----------------------------------------------------------------------------
  172. For MODEM
  173. ---------
  174.  
  175. The following ToolType may be added (SERIAL is default):
  176.  
  177.                               DEVICE=SERIAL
  178.  
  179.  
  180.  
  181. See:  Configuration 
  182. Applicable Configuration Commands:
  183.  
  184.      AUTOANSWEROFF   AUTOANSWERON   BAUDMODEM   DEVICE   DIAL   PHONE# 
  185.  
  186.                          SERIALDEVICE   SERIALUNIT 
  187. ============================================================================
  188. For AmiTCP/TCP:
  189. ----------------------------------------------------------------------------
  190. For AmiTCP/TCP:
  191. ---------------
  192.  
  193. AmiTCP must be running before GridLock is run.  GridLock requires the
  194. following line to be added to    AmiTCP:db/services
  195.  
  196.                          GridLock        2900/tcp
  197.  
  198. 2900 is the Port number that GridLock will use when initiating a network
  199. connection.  It is recommended that you use this number, unless it is in
  200. conflict with your system setup.  GridLock will use the 'case sensitive'
  201. alias as shown, in reference to this Port.
  202.  
  203. The following ToolType must be added:
  204.  
  205.                                 DEVICE=TCP
  206.  
  207.  
  208.  
  209. See:  Configuration 
  210. Applicable Configuration Commands:
  211.  
  212.                                DEVICE   HOST# 
  213.  
  214.                          SERIALDEVICE   SERIALUNIT 
  215. ============================================================================
  216. For Multi-I/O Cards:
  217. ----------------------------------------------------------------------------
  218. For Multi-I/O Cards:
  219. --------------------
  220.  
  221. The following ToolType must be modified to set the proper device handler.
  222.  
  223.  
  224.                                 SERIALDEVICE
  225.  
  226.  
  227. See:  Configuration 
  228. Applicable Configuration Commands:
  229.  
  230.                          SERIALDEVICE   SERIALUNIT 
  231. ============================================================================
  232. Connecting
  233. ----------------------------------------------------------------------------
  234. Connecting MODEM / NULL-MODEM
  235. -----------------------------
  236.  
  237. GridLock will detect if a modem is connected, automatically. The message
  238. window at the bottom of the title screen will read MODEM or NULL-MODEM,
  239. accordingly.  If you have a modem connected but it is turned off, the
  240. message window will display NULL-MODEM.
  241.  
  242. If the default baudrate is not wanted then select the baudrate under the
  243. BAUD menu.  Both computers must have the same baudrate set for play.
  244.  
  245.  For MODEM  use,
  246.  
  247.    -- One player should select DIAL under the MODEM menu.  This brings up
  248.       a requestor in which the phone number should be entered.  DIAL will
  249.       automatically prepend the defined prefix (ATDT is default).
  250.  
  251.                                    - OR -
  252.  
  253.       One player can select a phone number from the PHONE BOOK menu.
  254.       These phone numbers can be stored through the use of ToolTypes.
  255.       See:  Configuration 
  256.  
  257.    -- The other player should select AUTO ANSWER ON under the MODEM menu.
  258.       If this is already set on the modem, it need not be done again.
  259.       AUTO ANSWER ON sends an ATS0=1 command to the modem by default.
  260.       See:  Configuration 
  261.  
  262.       Auto Answer can be turned off by selecting AUTO ANSWER OFF under the
  263.       MODEM menu.
  264.  
  265.  
  266.  For NULL-MODEM  use,
  267.  
  268.    -- Insure that the NULL-MODEM cable is connected and continue ...
  269.  
  270.  
  271.  
  272. When both games are running at compatible baudrates and connection is
  273. detected, OPPONENT READY will appear on the title screen.
  274.  
  275. * The game will automatically check that both games are the same version.
  276. If this is not the case, NOT COMPATIBLE VERSION will appear on the title
  277. screen and the game will not continue.
  278. ============================================================================
  279. ConnectingTCP
  280. ----------------------------------------------------------------------------
  281. Connecting AmiTCP/TCP:
  282. ----------------------
  283.  
  284. The message window at the bottom of the title screen will read TCP.
  285.  
  286.  For AmiTCP/TCP:  use,
  287.  
  288.   *** BEFORE running GridLock, the DEVICE=TCP ToolType must be included
  289.       See:  For AmiTCP/TCP: 
  290.  
  291.  
  292.    -- First, one player should select OPEN PORT under the TCP menu.
  293.  
  294.     * NOTE: AmiTCP/TCP: will wait forever for a connection to this port.
  295.       GridLock has no control over this.  I have provided a script file
  296.       that will allow you to signal the OPEN PORT to ABORT.  Simply click
  297.       on the 'Kill-GridLockPort' icon and it will connect to the GridLock
  298.       Port and send a QUIT command.
  299.  
  300.    -- Then, the other player should select CONNECT TO HOST under the TCP
  301.       menu.  This brings up a requestor in which the Host Address or Host
  302.       Alias should be entered.  A null entry will abort the CONNECT TO
  303.       HOST.
  304.                                    - OR -
  305.  
  306.       The other player can select a Host from the HOSTS menu.  These Hosts
  307.       can be defined with ToolTypes.  See:  Configuration 
  308.  
  309.  
  310. When both games are running at compatible baudrates and connection is
  311. detected, OPPONENT READY will appear on the title screen.
  312.  
  313. * The game will automatically check that both games are the same version.
  314. If this is not the case, NOT COMPATIBLE VERSION will appear on the title
  315. screen and the game will not continue.
  316. ============================================================================
  317. Starting
  318. ----------------------------------------------------------------------------
  319. Starting
  320. --------
  321.  
  322. If OPPONENT READY is displayed on the title screen then connection has been
  323. established and GridLock may begin.
  324.  
  325. START may be selected from the GAME menu at this time.  When one player
  326. selects START from the GAME menu, both games will begin.
  327.  
  328. START may also be invoked through the keyboard equivalent 's'.
  329.  
  330. START is disabled while an opponent is editing or viewing a message or
  331. changing preferences.
  332. ============================================================================
  333. Screen Areas
  334. ----------------------------------------------------------------------------
  335. Screen Areas
  336. ------------
  337.  
  338. View GridLock.doc.pic for locations of the different areas and images used
  339. in the game.
  340. ============================================================================
  341. Movement and Energy Beams
  342. ----------------------------------------------------------------------------
  343. Movement and Energy Beams
  344. -------------------------
  345.  
  346. All game play is controlled by mouse or joystick.  To change the input
  347. device select the GRIDLOCK/PREFERENCES menu.
  348.  
  349.   MOUSE: Use the movement controls (the blue arrows with no lines) to
  350.          move your player.  See: GridLock.doc.pic
  351.  
  352.          Clicking with the left mouse-button activates the selected
  353.          direction.  Holding the mouse button down and positioning the
  354.          mouse pointer over any of the direction arrows will allow repeat
  355.          movements, without having to click the mouse button for each
  356.          movement.
  357.  
  358.   JOYSTICK: Push the joystick in the direction you wish to move.  Holding
  359.             the joystick in one direction will repeat movement in that
  360.             direction.
  361.  
  362. To the right of the direction controls are the energy beam generators,
  363. these are used to generate the beams in which to trap your opponent.
  364. These beams are not visible to your opponent unless he moves into them.
  365. You can not generate energy beams along the border of the Grid.
  366.  
  367.   MOUSE: Select these gadgets in the same manner as above.
  368.  
  369.   JOYSTICK: Press fire and hold it, then push the joystick in the
  370.             direction you wish to generate a low level beam.
  371. ============================================================================
  372. Opponent Activity Pulser
  373. ----------------------------------------------------------------------------
  374. Opponent Activity Pulser
  375. ------------------------
  376.  
  377. At the top of the opponent health display is an activity pulser.  This
  378. displays the activity level of your opponent.  It has three different
  379. display methods.  If your opponent is active, this displays a three level
  380. sizing pulse (small/medium/large).  After 9 'time units' of inactivity
  381. this will change to a non-pulse display.  When your opponent enters the
  382. health rejuvenation state (at 14 'time units') this will change to a 2
  383. level pulse (dark/bright), and your opponents position will be displayed
  384. while remaining in this state.
  385. ============================================================================
  386. Health
  387. ----------------------------------------------------------------------------
  388. Health
  389. ------
  390.  
  391. Moving into an opponent's low-level energy beam will absorb energy from
  392. you (decreasing your health) and will change the low level energy beam to
  393. a high level beam.  This is indicated on the Grid as a brighter beam.
  394. Watch for this, to determine where your opponent is.  The last wall that
  395. your opponent has moved into will flash (on/off) for 15 'time units' or
  396. until another wall is moved into.
  397.  
  398. Generating a beam where an opponent's beam is already located will also
  399. cause a health decrease.
  400.  
  401. Health decreases work as follows:
  402.  
  403.         Move into opponent's low-level beam:            -2 health
  404.         Move into opponent's high-level beam:           -0 health
  405.         Generate beam over opponent's low-level beam:   -4 health +
  406.         Generate beam over opponent's high-level beam:  -6 health +
  407.  
  408.         See:  Disruptions / Inactivity 
  409. ============================================================================
  410. Inactivity / Health Rejuvenation
  411. ----------------------------------------------------------------------------
  412. Inactivity / Health Rejuvenation
  413. --------------------------------
  414.  
  415. You may rejuvenate your health by stopping all movement for a period of 14
  416. 'time units'.  This will put you in the Rejuvenation state.  Beware that,
  417. while in this state, your Grid position is shown on your opponent's Grid
  418. display.  Health will rejuvenate at a rate of +4 health/'time unit', to a
  419. maximum of 150.
  420.  
  421. See:  Disruptions / Inactivity 
  422. ============================================================================
  423. Disruptors
  424. ----------------------------------------------------------------------------
  425. Disruptors
  426. ----------
  427.  
  428. Two types of Disruptors are available.
  429.  
  430. Timed Disruptor: These devices can be used to cause a timed disruption
  431.                  within the Grid location the Disruptor is placed in.
  432.                  These devices can provide a method of attempting escape
  433.                  when you are trapped within a Grid area -OR- can be used
  434.                  to cause health decrease to an opponent.  Disruption will
  435.                  be delayed by 4 'time units', giving you time to move
  436.                  away from the disruption area.  Only (1) Timed Disruptor
  437.                  may be active at a time.
  438.  
  439.                  A maximum of (3) are available per game.
  440.  
  441. Disruptor Trigger: These devices are used to attempt to cause health
  442.                    decrease to an opponent.  A disruption will be
  443.                    triggered if your opponent moves on to a Grid area
  444.                    containing one of these devices.
  445.  
  446.                    A maximum of (5) are available per game.
  447.  
  448.   MOUSE: Place a Disruptor device by clicking with the left mouse button,
  449.          in the Timed Disruptor -OR- Disruptor Trigger areas.
  450.          See: GridLock.doc.pic
  451.                                     -OR-
  452.  
  453.   JOYSTICK/MOUSE: Place a Timed Disruptor by pressing '1' on the keyboard.
  454.                   Place a Disruptor Trigger by pressing '2' on the
  455.                   keyboard.
  456.  
  457.  
  458. If you are positioned on a Grid location where a Disruption occurs, you
  459. will have a health decrease of 24.
  460. ============================================================================
  461. Disruptions / Inactivity
  462. ----------------------------------------------------------------------------
  463. Disruptions / Inactivity
  464. ------------------------
  465.  
  466. If you remain inactive, when positioned within a Level-1 Grid Disruption,
  467. Health Rejuvenation does not occur.  Instead, health will decrease as
  468. follows:
  469.  
  470.         Inactivity Level 0:      1-9 'time units'    -1 health
  471.                    Level 1:    10-13 'time units'    -2 health
  472.                    Level 2:    >= 14 'time units'    -4 health
  473. ============================================================================
  474. Teleportation Devices
  475. ----------------------------------------------------------------------------
  476. Teleportation Devices
  477. ---------------------
  478.  
  479. Generating four low level beams around yourself in one Grid sector will
  480. create a teleport, which will transport you to a random sector on the
  481. Grid.  Moving into one of these active teleports will have the same
  482. effect.  These can be used to get you out of a tight spot, or to put you
  483. into one.  You can not enter an opponent's teleport.  A teleport is not
  484. created if you are not positioned inside the enclosed Grid sector when
  485. you generate the fourth low level energy beam.  All four beams must be
  486. LOW LEVEL to generate a teleport.
  487.  
  488. MOUSE: Holding the left mouse button down and circling over the four
  489.        energy beam direction arrows provides a quick way to make a
  490.        teleport.
  491.  
  492. JOYSTICK: Pressing the fire button and circling the four directions with
  493.           the joystick provides a quick way to make a teleport.
  494. ============================================================================
  495. Phimping
  496. ----------------------------------------------------------------------------
  497. Phimping
  498. --------
  499.  
  500. Phimping occurs when both players are positioned within the same Grid
  501. location, at the same time.  This causes a disruption in the Grid and
  502. players' energies.  This is shown by flashing you and your opponent within
  503. the Grid location.  Phimping will continue as long as both players remain
  504. within this Grid location.  Phimping will not cause a health decrease.
  505. ============================================================================
  506. Pause Game
  507. ----------------------------------------------------------------------------
  508. Pause Game
  509. ----------
  510.  
  511. To pause the game, select PAUSE from the GAME menu, this will signal the
  512. opponent's computer to pause as well.  This option will display a message
  513. at the bottom of your screen, acknowledging that the game is paused.
  514. Press 'ESC' to return to the game.  Your opponent cannot restart the game.
  515. The player who pauses the game must continue it as well.
  516.  
  517. PAUSE may also be invoked through the keyboard equivalent 'p'.
  518.  
  519. PAUSE is disabled while an opponent is editing or viewing a message.
  520. ============================================================================
  521. End Game
  522. ----------------------------------------------------------------------------
  523. End Game
  524. --------
  525.  
  526. To leave the Grid, select END from the GAME menu, this will signal the
  527. opponent's computer to end as well.  This option will display your
  528. opponent's position and his energy beams on your screen.  Press any key to
  529. return to the title screen, where you may begin a new game.
  530.  
  531. END may also be invoked through the keyboard equivalent 'e'.
  532.  
  533. A new game can not begin until both players have returned to the title
  534. screen.  If your opponent has not returned to the title screen the top
  535. message window will display OPPONENT BUSY.  Start cannot be selected until
  536. this window reads OPPONENT READY.
  537.  
  538. END is disabled while an opponent is editing or viewing a message.
  539. ============================================================================
  540. Quitting
  541. ----------------------------------------------------------------------------
  542. Quitting
  543. --------
  544.  
  545. From the title screen, select QUIT from the GRIDLOCK menu to quit the
  546. program.  This will signal the opponent's computer that you have quit.
  547. ============================================================================
  548. Winning
  549. ----------------------------------------------------------------------------
  550. Winning
  551. -------
  552.  
  553. If your opponent selects END GAME or loses all his health, the GridLock
  554. logo will appear in the center of your game board, press any key to
  555. display the opponent's position and energy beams on your screen.
  556. ============================================================================
  557. Sending Messages
  558. ----------------------------------------------------------------------------
  559. Sending Messages
  560. ----------------
  561.  
  562. At the title screen (after connection has been made) or during the game,
  563. you can send messages to your opponent by pressing the SPACE-BAR.  Doing
  564. so will bring up a message requestor.  This message requestor supports
  565. left-right cursoring, auto insert, delete, and all characters except the
  566. quotation mark.  Pressing RETURN terminates the message entry and sends
  567. the message to your opponent.  A null message will not be sent.
  568.  
  569. Press 'ESC' to remove a message sent to you by your opponent.
  570.  
  571. You can not continue play while entering a message, or when an opponent's
  572. message is displayed on your screen.
  573. ============================================================================
  574. Configuration
  575. ----------------------------------------------------------------------------
  576. Configuration
  577. -------------
  578.  
  579. GridLock supports configuration through use of Workbench ToolTypes.  If
  580. any options are not included as a ToolType, the stated defaults will be
  581. used.
  582.  
  583. ToolTypes can be typed in upper or lower case or any combination of the
  584. two.  To have a ToolType ignored surround it with brackets ( ).
  585.  
  586. For example:
  587.                             (ToolType=Value)
  588.  
  589.  
  590. Invalid settings and ToolTypes will be ignored.  In this case, the default
  591. values will be used.
  592.  
  593. The following configuration commands are supported:
  594.  
  595.   AUTOANSWEROFF=
  596.     Description: this option allows the setting of the modem command sent
  597.                  when AUTO ANSWER OFF is selected from the MODEM menu.
  598.  
  599.     Valid values: See your modem manual for valid entries.
  600.  
  601.     Default: ATS0=0
  602.  
  603.     Example: AUTOANSWEROFF=ATS0=0
  604.  
  605.  
  606.   AUTOANSWERON=
  607.     Description: this option allows the setting of the modem command sent
  608.                  when AUTO ANSWER ON is selected from the MODEM menu.
  609.  
  610.     Valid values: See your modem manual for valid entries.
  611.  
  612.     Default: ATS0=1
  613.  
  614.     Example: AUTOANSWERON=ATS0=1
  615.  
  616.  
  617.   BAUDMODEM=
  618.     Description: this option allows the setting of the default baudrate
  619.                  for MODEM use.
  620.  
  621.     Valid values: 1200, 2400, 4800, 9600, 14400, 19200
  622.  
  623.     Default: 2400
  624.  
  625.     Example: BAUDMODEM=2400
  626.  
  627.  
  628.   BAUDNULL=
  629.     Description: this option allows the setting of the default baudrate
  630.                  for NULL-MODEM use.
  631.  
  632.     Valid values: 1200, 2400, 4800, 9600, 14400, 19200
  633.  
  634.     Default: 9600
  635.  
  636.     Example: BAUDNULL=9600
  637.  
  638.  
  639.   BRIGHTNESS=
  640.     Description: this option allows you to set the brightness level of the
  641.                  game screens.  This option is also available through the
  642.                  GRIDLOCK/PREFERENCES menu.
  643.  
  644.     Valid values: 0, 1, 2, 3
  645.  
  646.     Default: 0
  647.  
  648.     Example: BRIGHTNESS=3
  649.  
  650.  
  651.   CONTROL=
  652.     Description: this option allows the setting of the input device.  This
  653.                  option is also available through the GRIDLOCK/PREFERENCES
  654.                  menu.
  655.  
  656.     Valid values: JOYSTICK, MOUSE
  657.  
  658.     Default: JOYSTICK
  659.  
  660.     Example: CONTROL=MOUSE
  661.  
  662.  
  663.   DEVICE=
  664.     Description: this option allows the setting of the communication
  665.                  mode.
  666.  
  667.     Valid values: SERIAL, TCP
  668.  
  669.     Default: SERIAL
  670.  
  671.     Example: DEVICE=TCP
  672.  
  673.  
  674.   DIAL=
  675.     Description: this option allows the setting of the modem code sent
  676.                  preceeding the entered phone number.
  677.  
  678.     Valid values: See your modem manual for valid entries.
  679.  
  680.     Default: ATDT
  681.  
  682.     Example: DIAL=ATDP
  683.  
  684.  
  685.   HOST#=
  686.     Description: this option allows the setting of up to 10 Host Name
  687.                  entries (0-9).
  688.  
  689.     Syntax: HOST#=Text=HostAddress
  690.       Where: #           - is a number from 0 to 9.
  691.              Text        - is text to be displayed under the Hosts menu.
  692.              HostAddress - is a valid Host Address or Host Alias.
  693.  
  694.     Default: No Host entries.
  695.  
  696.     Example: HOST0=dhomas=123.123.123.1
  697.              HOST5=dhomas=A3000T
  698.              HOST9=dhomas=dhomas
  699.  
  700.   INTRO=
  701.     Description: this option allows the disabling/enabling of the
  702.                  soundeffects played at startup.
  703.  
  704.     Valid values: YES, NO
  705.  
  706.     Default: YES
  707.  
  708.     Example: INTRO=NO
  709.  
  710.  
  711.   PHONE#=
  712.     Description: this option allows the setting of up to 10 PHONE BOOK
  713.                  entries (0-9).
  714.  
  715.     Syntax: PHONE#=Text=PhoneNum
  716.       Where: #        - is a number from 0 to 9.
  717.              Text     - is text to be displayed under the PHONE BOOK menu.
  718.              PhoneNum - is a valid phone number to be dialed.
  719.  
  720.     Default: No phone entries.
  721.  
  722.     Example: PHONE3=Johnny Who=555-1515
  723.              PHONE5=Peter=555-1999
  724.              PHONE9=Zorna Bomp=111-1112
  725.  
  726.  
  727.   SERIALDEVICE=
  728.     Description: this option allows the setting of the device to use for
  729.                  serial communication with multi-I/O cards.
  730.  
  731.     Valid values: serial.device, ...
  732.  
  733.     Default: serial.device
  734.  
  735.     Example: SERIALDEVICE="duart.device"
  736.  
  737.  
  738.   SERIALUNIT=
  739.     Description: this option allows the setting of the unit number to
  740.                  use for serial communication with multi-I/O cards.
  741.  
  742.     Valid values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
  743.  
  744.     Default: 0
  745.  
  746.     Example: SERIALUNIT=1
  747.  
  748.  
  749.   SOUNDEFFECTS=
  750.     Description: this option allows the disabling/enabling of the
  751.                  soundeffects in the game.  Setting this to NO also
  752.                  disables the INTRO= soundeffects.
  753.  
  754.                * If you are experiencing OUT OF MEMORY ERRORS then try
  755.                  setting this option to NO.
  756.  
  757.     Valid values: YES, NO
  758.  
  759.     Default: YES
  760.  
  761.     Example: SOUNDEFFECTS=NO
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782. ============================================================================
  783. Error Messages
  784. ----------------------------------------------------------------------------
  785. Error Messages
  786. --------------
  787.  
  788. Time-out ERROR                                GridLock
  789.  
  790. - GridLock has received normal communication data but expected more
  791.   information.  Most likely, there is a problem with the connection
  792.   between computers.
  793.  
  794.  
  795. Port NOT found                                AmiTCP/TCP:
  796.  
  797. - GridLock was unable to connect to the GridLock port.  Insure that the
  798.   GridLock alias has been properly defined in your AmiTCP:db/services
  799.   file.  See:  For AmiTCP/TCP: 
  800.  
  801. - GridLock Port has not been opened by your opponent.
  802.  
  803. - Error in Host Address or Host Alias names.
  804.  
  805.  
  806. TCP: NOT mounted                              AmiTCP/TCP:
  807.  
  808. - AmiTCP/TCP: is not running or inet-handler is not being used.
  809.  
  810.  
  811. Error: ####                                   AmiTCP/TCP:
  812.  
  813. - GridLock has encountered an unexpected error when opening the GridLock
  814.   Port or attempting to connect to the GridLock Port.  Please inform me of
  815.   this error number if you encounter a problem with it.
  816. ============================================================================
  817. Legalness
  818. ----------------------------------------------------------------------------
  819. Legalness
  820. ---------
  821.  
  822. GridLock is copyright ©1990-1994 by Scotware\Software.  The files included
  823. with this distribution may not be altered in any way.  GridLock is
  824. released as Shareware - You are required to pay a  Shareware fee  if you
  825. continue to use this software.
  826.  
  827. The game concept and design remain the property of the author, scott dhomas
  828. trenn and Scotware\Software.
  829.  
  830. Without written permission:  This game may not be sold in any form, or be
  831. included on any disk with other programs being sold.  It may not appear on
  832. any magazine disk.
  833.  
  834. Permission is granted for this program to appear in the FRED FISH LIBRARY.
  835.  
  836. The author is in no way liable for any damage resulting from the use of
  837. this program.
  838. ============================================================================
  839. Future Enhancements
  840. ----------------------------------------------------------------------------
  841. Future Enhancements
  842. -------------------
  843.  
  844. -  More than two players
  845. -  Keyboard control
  846. -  Weapon control with mouse when in Joystick mode
  847. -  Replace iff.library with iffparse.library
  848. -  Replace direct hardware audio with audio.device calls
  849. -  Front/Back gadget
  850. -  New weapons: Kill, etc.
  851. -  More disruptors
  852. -  Modem commands: ATD, ATA, etc.
  853. -  Grid Demons (Programmable)
  854. -  Configurable colors
  855. -  Default baudrates for phone book entries
  856. -  Selectable Grid designs
  857. -  Grid design tool
  858. -  End of game determination ???
  859. -  Modem carrier drop detection
  860. -  GridLock font
  861. -  Music soundtrack
  862. -  Demo mode
  863. -  Save game
  864. -  Energy levels
  865. -  Energy failures
  866. -  Communication error checking (Not necessary for AmiTCP/TCP:)
  867. -  Playback of completed games (both players on one screen)
  868. -  EndGame buffer parsing
  869. -  and MORE...
  870. ============================================================================
  871. Known BUGS
  872. ----------------------------------------------------------------------------
  873. Known BUGS
  874. ----------
  875.  
  876. -  The game sometimes locks up upon first entering the Grid, requiring a
  877.    reboot.  I am aware of the problem, but can not find the reason for it.
  878.    I believe that this only occurs when using joystick.  This may have
  879.    been fixed.
  880.  
  881. -  Weird things may happen if both players are at the same location
  882.    and building beams and things.  This will require changing some of the
  883.    game method of play.  Soon.
  884.  
  885. -  OPPONENT BUSY is sometimes not being displayed.  Looking into this.
  886.    This may have been fixed.
  887.  
  888. -  Game decides to end all on its own.  Happens rarely, but it has
  889.    happened.  This may have been fixed.
  890. ============================================================================
  891. Locating The Author
  892. ----------------------------------------------------------------------------
  893. Locating The Author
  894. -------------------
  895.  
  896. If you like this program and would like to reward me for my efforts, or
  897. for bug reports, program ideas, or questions, or just to tell me about
  898. where you live.
  899.  
  900. I can be contacted through INTERNET EMAIL at:
  901.  
  902.  
  903.                               dhomas@unb.ca
  904.  
  905. Or by MAIL at:
  906.                             scott dhomas trenn
  907.                             Scotware\Software
  908.                            797 Mitchell Street
  909.                              Fredericton, NB
  910.                              CANADA  E3B 3S8
  911.  
  912.  
  913. Registered users may send me $5.00 (CANADIAN) and a disk, for the latest
  914. version of GridLock.
  915.  
  916. Be sure to include the version number you are currently using, and the
  917. name of the program you want, so I do not send you a version you already
  918. have or a program you do not want.  The version number can be found on the
  919. title screen just under the GridLock name, at the top of this .doc file
  920. just under the GridLock name, or by typing:
  921.  
  922.                              Version GridLock
  923.  
  924. at a shell prompt.  It looks similar to     93.Dec.12
  925.  
  926. When reporting bugs or errors generated when you run GridLock, please
  927. include any GURU numbers, error numbers or line numbers given by GridLock
  928. and also the version number you are using.  This will aid me in tracking
  929. down the problem.  Thank-you.
  930.  
  931. If you have an EMAIL address please include that with your letter.
  932. ============================================================================
  933. Thank Yous
  934. ----------------------------------------------------------------------------
  935. Thank Yous
  936. ----------
  937.  
  938. Thanks to the following people for beta-testing, suggestions, and bug
  939. reports:
  940.  
  941. - Alexander Wipf       -                             GERMANY (translation)
  942. - Fionn Behrens        -                             GERMANY
  943. - Terry Wood           - Winnindoo                   AUSTRALIA
  944. - Troy Morehouse       - Fredericton, New Brunswick  CANADA
  945. - Greg Patterson       - Montreal,    Quebec         CANADA
  946. - Nickey MacDonald     - Fredericton, New Brunswick  CANADA
  947. - The Shockwave Surfer - Fredericton, New Brunswick  CANADA
  948. - Karl Hoyt            - Saint John,  New Brunswick  CANADA
  949. - Todd Bailey          - Fredericton, New Brunswick  CANADA
  950. - John Tarrel          - Fredericton, New Brunswick  CANADA
  951.  
  952.  
  953. Thanks to the following people for their assistance implementing support
  954. for AmiTCP/TCP:
  955.  
  956. - Tomi Ollila          - too@cs.hut.fi
  957. - Markus Peuhkuri      - Markus.Peuhkuri@hut.fi
  958.  
  959. For more information about AmiTCP contact amitcp-group@hut.fi
  960.  
  961.  
  962.                                                             - dhomas trenn
  963. ============================================================================
  964. Previous versions
  965. ----------------------------------------------------------------------------
  966. New In Version 93.12.16
  967. -----------------------
  968.  
  969. - Complete rewrite of all communication routines.  As a result, there is
  970.   less data being transfered and it is more reliable.
  971.  
  972. - Implemented communication time-outs.
  973.  
  974. - Updated GridLock.pic with my new MAIL address and EMAIL address.
  975.  
  976. - 'INTRO=' configuration command added.
  977.  
  978. - Grid Disruptors and Disruptions now implemented.
  979.  
  980. - 'Preferences' menu removed.  Moved options to a Preferences editor
  981.   available from the 'GridLock/Preferences' menu.  Preferences editing is
  982.   now only available from the title screen.
  983.  
  984. - Phimping now implemented.
  985.  
  986. - Updated GridLock.pic2 to support Timed Disruptors.
  987.  
  988. - Modified the $VER string contents displayed by the DOS 'Version'
  989.   command.
  990.  
  991. - Menus are now disabled during message display.
  992.  
  993. - 'Opponent Busy' message now displayed when opponent is editing or
  994.   reading a message on the Title Screen.
  995.  
  996. - 'Game/Start' now disabled when opponent is busy on Title Screen.
  997.  
  998. - Null messages are no longer sent to opponent.
  999.  
  1000. - 'Game/Pause' and 'Game/End' are now disabled if opponent is editing a
  1001.   message.
  1002.  
  1003. - Updated GridLock.doc.pic to show new features.
  1004.  
  1005. - New sound effects.
  1006.  
  1007. - Inactivity is now determined from start of game, not from first movement
  1008.   as in previous versions.
  1009.  
  1010. - Modification to Inactivity occurances in conjuction with Disruptions.
  1011.  
  1012. - Improved the initial Connect communication method.
  1013.  
  1014. - Improved the GameEnd communication method.
  1015.  
  1016. - Added AmiTCP/TCP: support for networks.
  1017.  
  1018. - 'DEVICE=' configuration command added.
  1019.  
  1020. - 'HOST=' configuration command added.
  1021.  
  1022. - Fixed some display bugs.
  1023.  
  1024. - Added a method to assist me in finding bugs, should someone contact me.
  1025.  
  1026. - Converted documentation to AmigaGuide format.
  1027.  
  1028. - UnImproved the GameEnd communication method.
  1029.  
  1030. - ReImproved the GameEnd communication method.
  1031.  
  1032. - Improved the Configuration file parsing.
  1033.  
  1034. - Improved the speed of control processing.
  1035.  
  1036.  
  1037.  
  1038. New In Version 91.12.01
  1039. -----------------------
  1040.  
  1041. - Added some real sound... more to come... should play at the proper speed
  1042.   on PAL machines, too.
  1043.  
  1044. - 'SOUNDEFFECTS=' configuration command added.  Actually, it existed all
  1045.   along, it is just that I am the only one who knew it.
  1046.  
  1047. - Moved all the GridLock data files into their own directory GridLockData.
  1048.  
  1049. - Fixed a bug when checking if the serial port was free.  It could not
  1050.   always tell.  It worked with communication software but not with MIDI
  1051.   software.
  1052.  
  1053. - Open.Error routines improved.  If all the GridLock data files are in
  1054.   there proper place and none have been changed then you will never see
  1055.   this.
  1056.  
  1057. - Temporary flashing-WallBrights now implemented.
  1058.  
  1059. - 'Opponent Busy' bug fixed; but now there is a different one.
  1060.  
  1061. - Message display routine optimized.
  1062.  
  1063. - 'Pause' selection added to 'Game' menu.
  1064.  
  1065. - 'Mouse/Joystick' selection moved to 'Preferences' menu.
  1066.  
  1067. - Ghosted menus when in 'Game-Pause' and 'Game-End' modes.
  1068.  
  1069. - Cleaned up the GameEnd routines.
  1070.  
  1071. - Fixed the mysterious "What is he doing up there!!" bug, finally!  YEAH!
  1072.  
  1073. - Keyboard equivalents for 'Game-Start', 'Game-Pause' and 'Game-End'
  1074.   implemented.
  1075.  
  1076. - 'Info' menu changed to 'GridLock'.  Might become 'Project'.
  1077.  
  1078. - 'Rules' menu selection removed.
  1079.  
  1080. - Version compatibility check is now made.
  1081.  
  1082. - 'Activity Pulser' and 'Health Rejuvenation' now implemented.
  1083.  
  1084. - Changed some of the communication method.
  1085.  
  1086. - Slowed down the rate of health decrease when you try to build a wall
  1087.   where a wall already existed.
  1088.  
  1089. - Replaced timer checks and delays with functions that better handle the
  1090.   evil midnight.
  1091.  
  1092. - Added GridLock.doc.pic which shows the different areas of the game
  1093.   screen.
  1094.  
  1095.  
  1096.  
  1097. New In Version 91.10.23
  1098. -----------------------
  1099.  
  1100. - Support for WB2.x 'Version' command added.  You can now type:
  1101.  
  1102.                   Version GridLock
  1103.  
  1104.     from the SHELL/CLI and it will display the version of GridLock.
  1105.  
  1106. - 'BRIGHTNESS=' configuration command added.
  1107.  
  1108. - 'Preferences' menu added, for 'Brightness' setting.
  1109.  
  1110. - 'Quit' menu option is now disabled when playing game.  Use 'End Game'
  1111.   to quit the game and return to the title screen, where you may then
  1112.   quit GridLock.
  1113.  
  1114. - A '-- Opponent has QUIT --' message is now displayed when your opponent
  1115.   selects 'Quit' from the title screen.  When you press 'ESC' to clear the
  1116.   message, GridLock will exit.  The assumption is that, if you do not have
  1117.   anyone to play with then you will want to quit as well.
  1118.  
  1119. - Changed all the 'Busy Wait Loops', that would not effect the game play,
  1120.   so that they do not 'Busy Wait'.  (Greg!)
  1121.  
  1122.  
  1123.  
  1124. New In Version 91.09.14
  1125. -----------------------
  1126.  
  1127. - Fixed (???) no 'Phone Book' entries crash, under WB2.x
  1128.  
  1129. - Made the title-screen more multi-tasking.  I have not altered the game
  1130.   play multi-tasking as this does not provide consistent game play.  I am
  1131.   not, yet, convinced that there is a need for multi-tasking while playing
  1132.   the game! (Greg!)
  1133.  
  1134.  
  1135.  
  1136. New In Version 91.06.20
  1137. -----------------------
  1138.  
  1139. - Fixed an alternative NULL-MODEM cable bug
  1140.  
  1141.  
  1142.  
  1143. New In Version 91.03.02
  1144. -----------------------
  1145.  
  1146. - General beautifying and code cleanup.  Still more to come.
  1147.  
  1148. - Checks if required files are available.  Exits clean if any files
  1149.   are unavailable.
  1150.  
  1151. - Configuration file implemented
  1152.  
  1153. - No longer loads the grid with each new game
  1154.  
  1155. - Much less communication between computers
  1156.  
  1157. - Phone book implemented
  1158.  
  1159. - Exits cleanly if serial port is already in use
  1160.  
  1161. - MODEM / NULL MODEM determination
  1162.  
  1163. - Opponent READY / NOT READY
  1164.  
  1165. - Joystick control
  1166.  
  1167. - Opponent detection
  1168.  
  1169. - Walling an opponents wall, drops health
  1170.  
  1171. - Quit no longer exits game for opponent
  1172.  
  1173. - Health of 0 no longer exits the game
  1174.  
  1175. - Fixed lockup when modem turned off or on
  1176.  
  1177. - Gadget hi-lighting
  1178.  
  1179. - Menu activation based on conditions
  1180.  
  1181. - Messages can now be sent from title screen
  1182.  
  1183. - MODEM / NULL-MODEM message window on title screen
  1184.  
  1185. - Added 4800 baudrate
  1186.  
  1187. - Opponent teleports are now detected
  1188.  
  1189. - Now requires mathieeedoubbas.library.  Why?  I do not know!
  1190.  
  1191.  
  1192.  
  1193. New In Version 90.10.19
  1194. -----------------------
  1195.  
  1196. - REPEAT movement.
  1197.  
  1198. - Added 'Auto Answer OFF' to 'Modem' menu.  (Uses ATS0=0 command)
  1199.  
  1200. - Changed 'Auto Answer' menu option to 'Auto Answer ON'
  1201.  
  1202. - Now detects NULL-MODEM connection.
  1203.  
  1204.  
  1205.  
  1206. New In Version 90.10.11
  1207. -----------------------
  1208.  
  1209. - Support for 1200, 2400, 9600, and 19200 baud.  DEFAULT = 2400 baud
  1210.  
  1211. - Support for Modems.  (Uses ATDT and ATS0=1 commands)
  1212.  
  1213. - Allows setting of Auto-Answer on MODEM.
  1214.  
  1215. - Message requestor now supports the comma.
  1216.  
  1217. - You can no longer accidentally clear your opponent's message.  Now,
  1218.   press <ESC> to remove a message sent to you by your opponent.
  1219.  
  1220. - When END, from the GAME menu, is selected by either player, GridLock
  1221.   now displays your opponent's position when it shows the GRID.
  1222. ============================================================================
  1223. New in this version
  1224. ----------------------------------------------------------------------------
  1225. New In This Version
  1226. -------------------
  1227.  
  1228. - Major bug, which was the reason for most lock-ups, has been fixed.  This
  1229.   was a problem caused by the compiler, not my program.  YEAH!
  1230.  
  1231. - 'SERIALUNIT=' and 'SERIALDEVICE=' configuration commands added to allow
  1232.   multi-I/O card support.
  1233.  
  1234. - Status of the serial control lines is now determined by a SDCMD_QUERY
  1235.   call, rather than a direct hardware read.
  1236.  
  1237. - Null Phone Numbers are no longer dialed.
  1238.  
  1239. - In MODEM mode, exiting preferences no longer activates a connection.
  1240.  
  1241. - Updated my EMail address and the copyright year.
  1242.  
  1243. - Added Error.Handler for the serial device.
  1244.  
  1245. - Added support for 14400 baudrate.
  1246.  
  1247. - Replaced GridLock.cfg with support for Workbench ToolTypes.
  1248.  
  1249. - Changed the use of 'HOST=' and 'PHONE=' settings.
  1250.  
  1251. - Fixed error in Set.Brightness routine.
  1252.  
  1253. - Complete re-write of all serial communication.
  1254.  
  1255. - Text strings are now read from an external file.  German language file
  1256.   is now included.
  1257.  
  1258. - Current directory is now returned to entry state, upon exit.
  1259.  
  1260. - Implemented a connection re-syncing handler.
  1261.  
  1262. - Implemented "Connecting..." notification in NULL-MODEM mode.
  1263.  
  1264. - Updated GridLock.pic with wider message boxes and new graphics.
  1265.  
  1266. - Fixed bug in the preferences window, which always displayed 'Control' as
  1267.   Joystick, regardless of its setting.
  1268.  
  1269. - Updated GridLock.pic2 with new message and error boxes, and graphics.
  1270.  
  1271. - 'Press ESC...' and 'Press ANY KEY...' message directives added.
  1272.  
  1273. - New icons.
  1274.  
  1275. - Added German text installation script and icon.
  1276. ============================================================================
  1277.